docs: focus the site on the language, one door and seven pages - #9
Merged
Conversation
Setup now hands the reader a complete contract before asking them to run one, and says where to file an issue when something breaks. The root door stops duplicating the language overview (the section is retitled "The language"), the seam page defines its state terms abstractly and names Reactor once, pointing at the repo for the harness reference.
The section folder was scaffolding from when the site had six sections; with one topic left it forced every visitor through two overview pages with the same job. Pages now live at the root in learning order, with Setup right after the door. The section index is gone (its content already lived on the pages it summarized) and every old /openprose/* link redirects to its new home.
josemontesdeoca
force-pushed
the
chore/language-first-docs
branch
from
July 28, 2026 18:27
2c1a9a8 to
8ce7589
Compare
The contracts page's two program panels inherited the inline-code chip styling from the typography layer, painting a cream box behind every line; the panel now opts out. Markdown fences soft-wrap on narrow viewports so their sentences stay readable (the fence language is now exposed as an attribute for styling), the one four-column table drops its overflow column into the paragraph below it, and prose across the site stops rendering literal double hyphens where a dash was meant. The theme toggle is gone: the site is light-only by design and the control did nothing.
The fence-language styling hook becomes the built-in addLanguageClass flag; the custom transformer was silently replacing the default code notation transformers. The redirect table collapses to one entry per archived section (a wildcard source also matches its bare prefix), the mobile soft-wrap now covers the program panels too, and the theme switch is disabled where the rest of the layout config lives.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
The docs site now covers the language and nothing else, as one door and seven pages: what OpenProse is, setup via the skill, declaring outcomes, contracts, ProseScript, the typed image, and the harness seam.
Structure
Reading path
Rendering
Checks: typecheck, tests, lint, spell, the em-dash gate, and the internal link checker all pass.